home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / pmnscomp.z / pmnscomp
Text File  |  1998-10-20  |  7KB  |  133 lines
  1.  
  2.  
  3.  
  4. PPPPMMMMNNNNSSSSCCCCOOOOMMMMPPPP((((1111))))                                                        PPPPMMMMNNNNSSSSCCCCOOOOMMMMPPPP((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ppppmmmmnnnnssssccccoooommmmpppp - compile an ASCII performance metrics namespace into binary
  10.      format.
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      ppppmmmmnnnnssssccccoooommmmpppp [----dddd] [----ffff] [----nnnn _n_a_m_e_s_p_a_c_e] [----vvvv _v_e_r_s_i_o_n] _o_u_t_f_i_l_e
  14.  
  15. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.      ppppmmmmnnnnssssccccoooommmmpppp compiles a Performance Metrics Name Space (PMNS) in ASCII format
  17.      into a more efficient binary representation.  ppppmmmmLLLLooooaaaaddddNNNNaaaammmmeeeeSSSSppppaaaacccceeee(3) is able
  18.      to load this binary representation significantly faster than the
  19.      equivalent ASCII representation.
  20.  
  21.      If _o_u_t_f_i_l_e already exists ppppmmmmnnnnssssccccoooommmmpppp will exit without overwriting it.
  22.  
  23.      By convention, the name of the compiled namespace is that of the root
  24.      file of the ASCII namespace, with ....bbbbiiiinnnn appended.  For example, the root
  25.      of the default PMNS is a file named rrrrooooooootttt and the compiled version of the
  26.      entire namespace is rrrrooooooootttt....bbbbiiiinnnn.
  27.  
  28.      The options are;
  29.  
  30.      ----dddd   By default the PMNS to be compiled is expected to contain at most
  31.           one name for each unique Performance Metric Id (PMID).  The ----dddd
  32.           option relaxes this restriction and allows the compilation of a PMNS
  33.           in which multiple names may be associated with a single PMID.
  34.           Duplicate names are useful when a particular metric may be logically
  35.           associated with more than one group of related metrics, or when it
  36.           is desired to create abbreviated aliases to name a set of frequently
  37.           used metrics.
  38.  
  39.      ----ffff   Force overwriting of an existing _o_u_t_f_i_l_e if it already exists.
  40.  
  41.      ----nnnn   Normally ppppmmmmnnnnssssccccoooommmmpppp operates on the default PMNS, however if the ----nnnn
  42.           option is specified an alternative namespace is loaded from the file
  43.           _n_a_m_e_s_p_a_c_e.
  44.  
  45.      ----vvvv   By default, ppppmmmmnnnnssssccccoooommmmpppp writes a version 0000 compiled namespace, which is
  46.           compatible with versions of PCP before PCP2.0.  If _v_e_r_s_i_o_n is 1111 then
  47.           ppppmmmmnnnnssssccccoooommmmpppp will write a version 1111 namespace which is compatible with
  48.           PCP2.0 or later.  Note that PCP version 2.0 or later can handle both
  49.           versions but PCP versions prior to PCP 2.0 can only handle version 0000
  50.           compiled namespaces.
  51.  
  52.      The default input PMNS is found in the file /_v_a_r/_p_c_p/_p_m_n_s/_r_o_o_t unless the
  53.      environment variable PPPPMMMMNNNNSSSS____DDDDEEEEFFFFAAAAUUUULLLLTTTT is set, in which case the value is
  54.      assumed to be the pathname to the file containing the default input PMNS.
  55.  
  56. CCCCAAAAVVVVEEEEAAAATTTT
  57.      Once the writing of the new _o_u_t_f_i_l_e has begun, the signals SIGINT, SIGHUP
  58.      and SIGTERM will be ignored to protect the integrity of the new file.
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. PPPPMMMMNNNNSSSSCCCCOOOOMMMMPPPP((((1111))))                                                        PPPPMMMMNNNNSSSSCCCCOOOOMMMMPPPP((((1111))))
  71.  
  72.  
  73.  
  74. FFFFIIIILLLLEEEESSSS
  75.      /_v_a_r/_p_c_p/_p_m_n_s/*         default PMNS specification files
  76.      /_v_a_r/_p_c_p/_p_m_n_s/_r_o_o_t._b_i_n  compiled version of the default PMNS, when then
  77.                              environment variable PPPPMMMMNNNNSSSS____DDDDEEEEFFFFAAAAUUUULLLLTTTT is unset
  78.      /_v_a_r/_p_c_p/_p_m_n_s/_s_t_d_p_m_i_d   some standard macros for PMID generation
  79.  
  80. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  81.      ppppmmmmnnnnssssaaaadddddddd(1), ppppmmmmnnnnssssddddeeeellll(1), ppppmmmmnnnnssssmmmmeeeerrrrggggeeee(1), ppppmmmmLLLLooooaaaaddddNNNNaaaammmmeeeeSSSSppppaaaacccceeee(3),
  82.      ppppmmmmTTTTrrrriiiimmmmNNNNaaaammmmeeeeSSSSppppaaaacccceeee(3) and ppppmmmmnnnnssss(4).
  83.  
  84. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  85.      Cannot open ``xyz'' - the filename for the root of the PMNS that was
  86.      passed to ppppmmmmLLLLooooaaaaddddNNNNaaaammmmeeeeSSSSppppaaaacccceeee(3) is bogus
  87.  
  88.      Illegal PMID - either one of the three PMID components (see ppppmmmmnnnnssss(4)) is
  89.      not an integer, or the value for one of the components is negative, or
  90.      too large.
  91.  
  92.      Expected ... - specific syntax errors when a particular type of lexical
  93.      symbol was expected and not found; the messages are intended to be self-
  94.      explanatory.
  95.  
  96.      Internal botch - implementation problem for the parser ...
  97.  
  98.      Duplicate name ``abc'' in subtree for ``pqr.xyz'' - for each non-leaf
  99.      node, the names of all immediate descendents must be unique.
  100.  
  101.      No name space entry for ``root'' - the special non-leaf node with a
  102.      pathname of ``root'' defines the root of the PMNS, and must appear
  103.      somewhere in the PMNS specification.
  104.  
  105.      Multiple name space entries for ``root'' - more than one ``root'' node
  106.      does not make sense!
  107.  
  108.      Disconnected subtree (``abc.xyz.def'') in name space - the pathname for
  109.      this non-leaf node does not correspond to any pathname in the PMNS, hence
  110.      this non-leaf node is ``orphaned'' in the PMNS.
  111.  
  112.      Cannot find definition for non-terminal node ``xyz'' in name space - a
  113.      non-terminal node is named as part of its parent's specification, but is
  114.      never defined.
  115.  
  116.      Duplicate metric id (xxx) in name space for metrics ``abc'' and ``xyz'' -
  117.      each PMID must be unique across the PMNS.
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.